//
// FIRMWARE CHANGELOG
//
// v2.1.1
// - Fix of polarized pixel formats definitions
//
// v2.1.0
// - Added Sequencer Control feature
// - Fix of clock enable gating logic to avoid the replication of the last 4 pixels
// - Fixed Liquid Lens peripheral init when using User Sets and feature streaming/perstistence
// - Fix of AOI offsets when switching between normal and binning or decimation mode
// - Increased burst acquisition limit to 256 frames
// - Fix swapped internal signals for serial communication
// - Optimized concurrent operation of auto exposure, auto gain and auto white balance
// - Fix availability of CCM features, depending on pixel format value (CCM available only for RGB8 and YUV422)
// - Added support for IMX249 sensor
// - Extended support for polarized image sensors: auto exposure, auto gain, auto white balance and defective pixel correction
//
// v2.0.2
// - Fix of the synchronization stage of line inputs
//
// v2.0.1
// - Improvements in line-to-line dark signal non-uniformity in IMX342, IMX367 and IMX387 sensors
// - Fix of debounce feature and improvements in the synchronization stage of line inputs
// - Fix of debayering artifacts when operating with horizontal binning or decimation
// - Fix of wrong ExposureTime in the chunk data
//
// v2.0.0
// - New and more robust firmware update procedure
// - Improvements in Flash memory protection and security
// - Bootloop handler in case of CRC o WDT errors
// - Added led blink during firmware update
//
// v1.5.3
// - Improved encoder peripheral capabilities
// - Fix CCM issue with YUV422_8 pixel format 0 values
// - Fix of liquid lens controller spurious disconnections
// - Fix of ExposureActive signal duration in specific modes of operations
// - Fix of acquisition lock when changing the ExposureTime
// - ExposureActive signal now reflects the real exposure time when operating in TriggerWidth mode
// - Added support for polarized image sensors
// - Fix of Height and OffsetY increment for 4th gen. sensors, now equal to 8
// - Fix of Dual Exposure mode second exposure trigger inhibition time
//
// v1.5.2
// - Fix of EEPROM corruption due to a failure in the external liquid lens electronics.
//
// v1.5.1
// - Fix of liquid lens controller disconnection in specific operating conditions
// - Changed LineMode access mode to RW
// - oePtpOffsetFromUtc is now a streamable feature
// - Fix of TimerXActive pulse duration
// - Fix of Pulse Generator pulse duration
//
// v1.5.0
// - Major improvement in Exposure management. Better granularity and less jitter.
// - Fix of an unwanted behavior triggered from the Stop Acquisition in very specific configurations
// - Short exposure mode enhancement, PLS is not a problem anymore
// - Memory timings enhancement
// - Fix of an unespected behavior of the feature streaming function
// - Fix of an unespected behavior of the UserSet save process
//
// v1.4.4
// - Improved autoexposure setting (absolute value computation now moved inside the autoexposure function)
// - Removed feature "Short Exposure Enable" for Sony 4th generation sensors
// - Removed direct access to imx struct for gev_reg init -> now dedicated oe_imx functions are present
// - Fix CCM bug with negative coefficients
// 
// v1.4.3
// - Fix of Line0 and Line1 input source for the Encoder Control block
//
// v1.4.2
// - Fix of Trigger Width exposure mode
//
// v1.4.1
// - Fix of DeviceLinkThroughputLimit calculation
// - Fix of dual exposure initialization
// - Fix of enable sequence of liquid lens controller
// - Fix of wrong negative current setting on liquid lens at startup
// - Fix of oeResultingExposureTime update
// - Fix of short exposure limits
// - Fix of sensor gain reflection timings
// - Fixed Mono8 test pattern representation (color cameras)
// - Optimized chunk data packing
// - Fix of border artifacts caused by CCM
// - Fix of Width/Height chunk data lack of update when enabling binning/decimation
// - Improvement of DPC algorithm for different sensor readout modes
// - Update of streamable attributes
// - Fix of read/write peripherals shadow registers
// - Added oeResultingExposureTime invalidator on oeResultingFrameRate
// - Set SCPD feature as read-only in order to keep consistency with DeviceLinkThroughputLimit
// - Fix of autoexposure when used in binning/decimation mode
// - Removed autoexposure in short exposure mode
// - Defective pixel array edit is now possible only in full frame mode
// - Removed TimerXStart as TimerTriggerSource
// - Added 1us limit for minimum exposure
//
// v1.4.0
// - Added compatibility with liquid lens EL-16-40-TC-20D (EEPROM version 6.2) and EL-12-30-TC (EEPROM version 16.0)
// - Integration of Sony IMX 4th gen sensors
// - Update of the display precision of all float features
// - Update of pInvalidator node of PixelFormat feature
// - Minor fix in the test pattern generator 
// - Improvement of liquid lens I2C bus stability
// - Fix GEV 2.1 version issue
// - Added delay compensation for scheduled action trigger
// - Minor fix in I/O peripheral
// - Fix UserSet bug in trigger mode
// - Lock of AcquisitionStart when TLParamsLocked is equal to 0
// - Improvement of AcquisitionStop reliability
// - Fix of the Mono10Packed pixel format namespace
// - Removed Gain unit of measurement
// - Fix of EventNotification status for Test event
// - GigEVision 2.2 compliant
// - Fix of CCM coefficients init
// - Added SFNC version feature
// - Added new Dual Exposure feature
//
// v1.3.2
// - Bug fix: debayering of first and lats line corrected
//
// v1.3.1
// - Bug fix TimerDelay
//
// v1.3.0
// - FPGA resources optimization 
// - Improvement of ExposureActive signal timings accuracy
// - Added TriggerDelay feature
// - Fix of maximum supported action commands
// - Fix of action commands queue size
// - Optimization of action commands management
// - Scheduled action commands with action time in the past are now executed immediately
// - Improvement of the debayering algorithm
// - Added serial protocol: Modbus RTU
// - Added serial protocol: binary
// - "Plain" serial protocol has been renamed into "ASCII" protocol
// - Fix of chunk data content for color pixel formats
// - Optimization of image sensors configuration
//
// v1.2.2
// - Fix configuration of IMX267 and IMX304 sensors
// - Minor stability improvement
//
// v1.2.1
// - Minor bug fix
//
// v1.2.0
// - Added feature to manage 10 bit sensor data
// - Added TimerDelay parameter 
// - Fix of wrong burst length setting
// - Fix of wrong max bandwisth in DeviceLinkThroughputLimitSCPDConv
// - Fix sensor temperature reading for all the supported sensor families
// - Fix some incoherency to the GenICam validation tool
// - Implemented oeResultingExposureTime and oeResultingGain features
// - Updated xml for decimation and binning features
// - Implemented TimestampLatch, TimestampReset and TimestampLatchValue GenICam features
// - Implemented PTP features
// - Action command features implemented
// - Added the ActionUnconditionalMode feature
// - Added action commands support
// - If the time tag of the scheduled action command is in the past, the device executes this action command immediately
// - Removed TimestampReset feature
// - Moved the UserSetLoad pInvalidator directly to the "Device" port
// - Added mandatory <pInc> attribute to TimestampLatchValue, calculated from GEV TimestampTickFrequency register
// - Set increment of Width to 8
//
// v1.1.5
// - Liquid lens controller bug fix
// - Updated the firmware management of gigevision commands
//
// v1.1.4
// - Added limits checks to binning and decimation
// - Fixed IMX267 configuration
// - Changed default white balance ratios in order to match a neutral/warm light
// - Fix XML invalidators for oeLiquidLens features
//
// v1.1.3
// - Changed the liquid lens temperature variable from unsigned int to float
// - Added CRC check of the liquid lens EEPROM
// - Added DeviceLinkHeartbeatMode, DeviceLinkHeartbeatTimeout and DeviceLinkCommandTimeout to Genicam tree
// - Optimization of LoadUserSet command
// - Added "Once" option for BalanceWhiteAuto feature
// - Updated xml features ("TimerValue", "CounterValue", "EncoderValue")
// - Added TestControl category
// - Added TestEventGenerate feature
// - Added EventTest feature
//
// v1.1.2
// - Solved bug in auto-exposure/gain/white-balance
//
// v1.1.1
// - Added oeLiquidLensResultingCurrent and oeLiquidLensResultingPower features
// - Changed the way the lens current/power are read from GenAPI (removed 2 timout attributes)
// - Fixed a buffer overflow on the liquid lens part number
// - Added the <DisplayPrecision> attribute to all the <Float> features
// - Minor bug fix
//
// v1.1.0
// - Fixed Short Exposure Mode offset for IMX265 and IMX267
// - Added the AutoWhiteBalance feature
// - Tested color features (binning, decimation, defective pixel correction)
// - Solved bug in pixel format MONO8 for color sensor (v1.0.15d)
//
// 1.0.13
// - Force the update of Width and Height nodes when the PixelFormat is changed
// - Force the update of AOI Width and AOI Height nodes when Width or Height are changed
//
// 1.0.12
// - Set default FrameRateLimit to 100fps
// - Set default FrameRateLimitEnable to Disable
// - Added "oeResultingFrameRate" feature
//
// 1.0.11
// - Update "streamable" attributes
// - Updated trigger source function
//
// 1.0.10
// - Solved bug in Defective pixel correction
//
// 1.0.9
// - Speed up the algorithm for defective pixel sorting and duplicate removing
//
// 1.0.8
// - Added some Gev Features
// - Added "streamable" attributes to the XML
//
// 1.0.7
// - User Set bug fix
//
// 1.0.6
// - Increased robustness of internal peripherals libraries
//
// 1.0.5
// - Update of UserSetLoad function
//
// 1.0.4
// - Color Correction Matrix and Defective Pixel Map saved in a dedicated FLASH space
// - The User can save custom CCM and DPC only in his "User Set 0" and "User Set 1"
//
// 1.0.3
// - New timestamp selection logic for chunk data
//
// 1.0.2
// - Fix DeviceReset command acknowledge
// - Fixed reverse x/y bug
// - Added ChunkModeActive and ChunkEnable invalidators to PayloadSize
//
// 1.0.1
// - Alignment of fw version
//
// 1.0.0
// - *versioning starting point*